home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Desktop Improver / Homer / AMosaic < prev    next >
Encoding:
Text File  |  1996-09-27  |  9.4 KB  |  281 lines
  1. <HTML>
  2. <HEAD>
  3.     <!-- $VER: Homer.html 1.1 (21.4.96) -->
  4.     <TITLE>Homer Documentation</TITLE>
  5. </HEAD>
  6.  
  7. <BODY>
  8.  
  9. <CENTER>
  10. <H1><IMG ALT="Icon" SRC="HomerIcon.gif">Homer Documentation</H1>
  11. Copyright (C)1995-96 <A HREF="#Author">David Swasbrook</A>, All Rights Reserved.<BR>
  12.  
  13. <P>
  14. [ <A HREF="#Disclaimer">Disclaimer</A>
  15. | <A HREF="#Requirements">Requirements</A>
  16. | <A HREF="#Freeware">Freeware</A>
  17. | <A HREF="#Install">Installation & Use</A>
  18. | <A HREF="#Interface">Interface</A>
  19. | <A HREF="#History">History</A>
  20. | <A HREF="#Index">Index</A>
  21. ]<BR>
  22.  
  23. <P><IMG ALT="Definition Of" SRC="HomerDict.gif">
  24. </CENTER>
  25.  
  26.  
  27. <!-- ****************** -->
  28.  
  29. <HR><!-- *** DISCLAIMER *** -->
  30. <A NAME="Disclaimer"><H1>Disclaimer</H1></A>
  31.  
  32. Homer is supposed to be a replacement function for the exec.library/Alert function. Operations of
  33. this type are always risky, as when an alert occurs the system is in an inconsistent and/or defective
  34. state.
  35.  
  36. <P> I hereby reject any liability or responsibility for these or any other consequences from the use of
  37. Homer whatsoever. This includes, but is not limited to, damage to your equipment, to your data,
  38. personal injuries, financial loss or any other kinds of side effects.
  39.  
  40. <P>Although Homer has been tested thoroughly on several different machines, I cannot rule out the
  41. possibility that Homer
  42. <UL>
  43. <LI>is somehow incompatible to your equipment
  44. <LI>has bugs that show up on your equipment
  45. <LI>does not do what it is supposed to do on your equipment
  46. </UL>
  47. It is your responsiblity to take any precautions necessary to protect yourself from these or any other
  48. effects. I explicitly reject any liability or responsibility from the consequences of you using Homer.
  49.  
  50. <!-- ****************** -->
  51.  
  52. <HR><!-- *** REQUIREMENTS *** -->
  53. <A NAME="Requirements"><H1>Requirements</H1></A>
  54.  
  55. <P>The following are required for Homer to run, if they are not installed or available
  56. Homer will be unable to run.
  57.  <UL>
  58.  <LI>Kickstart V38 or higher
  59.  <LI>matrix.library V25 or higher (included in standard distribution)
  60.  <LI>swazconfig.library V3 or higher (included in standard distribution)
  61.  </UL>
  62.  
  63. <P>
  64. Optional extras:
  65.   <UL>
  66.   <LI>SwazBlanker - Homer window can be blanked too!
  67.   </UL>
  68.  
  69. <!-- ****************** -->
  70.  
  71. <HR><!-- *** FREEWARE *** -->
  72. <A NAME="Freeware"><H1>Freeware</H1></A>
  73.  
  74. Homer is <B>FREEWARE</B>, this means that you may use it as much as you like without having
  75. to feel guilty about it. You can always drop me a line or two with some comments about it. They
  76. are most welcome!
  77.  
  78. <P>The program may be freely distributed and copied, as long as the following conditions are fulfilled:
  79.  
  80. <UL>
  81. <LI>The sales price must not be higher than the cost of an (empty)
  82. disk plus a nominal copying fee plus costs for shipping. The total
  83. price must not be higher than 5 US$.
  84. <LI>All parts of the program and the documentation must be complete.
  85. You may howerver add or remove samples as you see necessary.
  86. <LI>Homer or parts of it may not be sold in combination with or
  87. as part of commercial software.
  88. <LI>Program and documentation may not be changed in any way.
  89. <LI>Permission has been given for distribution through Aminet and
  90. Fred Fish.
  91. </UL>
  92.  
  93. <!-- ****************** -->
  94.  
  95. <HR><!-- *** INSTALLATION AND USE *** -->
  96. <A NAME="Install"><H1>Installation And Usage</H1></A>
  97.  
  98. <DL>
  99. <DT><H3>Installation</H3>
  100. <DD>
  101. To install just run the install script provided in the Homer distribution. This will install
  102. Homer in your "SYS:WBStartup" drawer by default. Documentation and support files
  103. are also installed.
  104.  
  105. <P>
  106. You will be prompted for a Hot-Key to open the <A HREF="#Interface">main interface window</A>.
  107. Typically this would be something like "LALT a", ie. pressing the "LEFT ALT KEY"
  108. and the "a" key simultaneously would open the interface.
  109.  
  110. <DT><H3>Usage</H3>
  111.  
  112. <DD>
  113. To run homer simply <B>Double Click</B> the icon.<BR>
  114. Homer will pop up in a small window on your Workbench screen and his eyes will follow the
  115. mouse pointer as it moves. They also occasionally blink, and he also has the tendency to
  116. say things occasionally. Please feel free to <A HREF="#AddSample">add your own samples</A>
  117. and <A HREF="#Config">configure</A> Homer as you like it best!
  118. </DL>
  119.  
  120. <!-- ****************** -->
  121.  
  122. <HR><!-- *** CONFIG *** -->
  123. <A NAME="Config"><H1>Configuration File</H1></A>
  124.  
  125. In the Homer directory there is a configuration file named <A HREF="Homer.conf">Homer.conf</A>.
  126. This is a plain text file, made up of several sections as follows:
  127. <DL>
  128. <P><DT><B>[Homer]</B>
  129. <DD>This is where you can configure certain aspects of Homer
  130. <UL>
  131. <LI>ScaleFactor - how big should the image of Homer be. Eg. If you specify 200% the image will
  132. be twice the size it normally is.
  133.  
  134. <LI>DoBurp - weighted chance of Homer burping
  135. <LI>DoDoh - weighted chance of Homer saying Doh! (See also ManyDohChance)
  136. <LI>DoMood - weighted chance of Homer having a mood swing
  137. <LI>DoTalk - weighted chance of Homer saying something
  138.  
  139. <LI>ManyDohChance - chance of Homer saying Doh! several times (See also ManyDohContChance)
  140. <LI>ManyDohContChance - chance of Homer continuing to say Doh!
  141. </UL>
  142.  
  143. <P><DT><B>[HappySamples], [SadSamples], [AngrySamples], [BurpSamples], [DohSamples]</B>
  144. <DD>These all define the sample filenames depending on Homers mood or current
  145. action, these files are located in the Samples directory. Please try to avoid putting spaces
  146. in the filenames. Please feel free to <A HREF="#AddSample">add your own samples</A>
  147. </DL>
  148.  
  149. <!-- ****************** -->
  150.  
  151. <HR><!-- *** ADDSAMPLE *** -->
  152. <A NAME="AddSample"><H1>Adding Samples</H1></A>
  153.  
  154. This section gives you details on how to add your own samples to Homer.
  155. <UL>
  156. <LI>Sample file names should not contain spaces
  157. <LI>Samples should be in a sound.datatype supported format
  158. </UL>
  159.  
  160. <H3>To add a sample, please follow these steps...</H3>
  161. <OL>
  162. <P><LI>
  163. Locate the <B>Samples</B> directory (this is in the same directory as Homer), and copy your new
  164. samples into this directory.
  165. <P><LI>
  166. Then edit the <A HREF="#Config"><B>Homer.conf</B></A> configuration file, this is in the same directory as Homer (Load
  167. it into any standard ASCII text editor).
  168. <P><LI>Now decide what sort of sample you have, it can fall into one of the following categories:
  169. <UL TYPE=DISC>
  170. <LI>HappySamples
  171. <LI>SadSamples
  172. <LI>AngrySamples
  173. <LI>BurpSamples
  174. <LI>DohSamples
  175. </UL>
  176.  
  177. <P><LI>Locate the relevent section in the configuration file. Eg. if we have decided that the
  178. sample being added is a Happy Sample then look for the line reading <B>[HappySamples]</B> and
  179. enter the name of the sample on one of the lines following.
  180.  
  181. <P><LI>Now save the configuration and re-load Homer.
  182.  
  183. </OL>
  184.  
  185. If you find some samples that you think would be suitable for inclusion in the main distribution
  186. of Homer please feel free to send them to me (or at least tell me where I can obtain them from!)
  187.  
  188. <!-- ****************** -->
  189.  
  190. <HR><!-- *** INTERFACE *** -->
  191. <A NAME="Interface"><H1>Interface</H1></A>
  192.  
  193. The Homer window consists of an animated head of Homer, his eyes blink and follow the mouse pointer
  194. as you move it. He has also been known to say the occasional phrase.
  195.  
  196. <H3>Keys</H3>
  197. <P>The following keys do special things:
  198. <UL>
  199. <LI>ESCAPE - Quits
  200. <LI>TAB - Changes homers mood
  201. <LI>RETURN - Say something
  202. <LI>Any other key will show the definition of Homer from the dictionary
  203. </UL>
  204.  
  205. <H3>Homer Window Blanker</H3>
  206. If you ever find that the Homer window has gone completely black, dont worry, just click in the
  207. window and he will come back (eventually)... he is just merely blanking his window while your
  208. screen blanks (only currently supported with SwazBlanker).
  209.  
  210. <!-- ****************** -->
  211.  
  212. <HR><!-- *** HISTORY *** -->
  213. <A NAME="History"><H1>History</H1></A>
  214.  
  215. <UL>
  216. <LI><B>V1.1</B>
  217. <UL>
  218. <LI>Installer Script
  219. <LI>Documentaion
  220. <LI>Images are now stored as GIFs
  221. </UL>
  222. <LI><B>V1.0</B>
  223. <UL>
  224. <LI>Initial beta release, no install scripts or documentation, hey I dont want to
  225. waste too much time writing this toy :)
  226. </UL>
  227. </UL>
  228. <!-- ****************** -->
  229.  
  230. <HR><!-- *** AUTHOR *** -->
  231. <A NAME="Author"><H1>Author</H1></A>
  232.  
  233. <P>My real name is David Swasbrook but pretty much well everyone calls me <B>Swaz</B>.
  234. I have lived my entire life in New Zeland and have been programming Amigas since
  235. sometime around 1991, and plan to keep programming them for some time to come!
  236.  
  237. <P>Quite often I will be hanging out in Internet Relay Chat (Undernet mostly) in #Amiga channel
  238. under the nick of Swaz.
  239.  
  240. <P>You can find me on the World Wide Web at
  241. <A HREF="http://www.ait.ac.nz/~swaz/"><B>http://www.ait.ac.nz/~swaz/</B></A>
  242. or if I have moved you might be able to get me via
  243. <A HREF="http://www.pobox.com/~swaz/">http://www.pobox.com/~swaz/</A>.
  244. <BR>
  245.  
  246. <P>Electronic Mail may be sent to me at <A HREF="mailto:swaz@ait.ac.nz">swaz@ait.ac.nz</A>,
  247. or if for some strange reason that fails you could try
  248. <A HREF="mailto:swaz@pobox.com">swaz@pobox.com</A>.
  249.  
  250. <P>If you would like to send me some mail the old fashioned way, my mailbox is:
  251. <DL>
  252. David Swasbrook,<BR>
  253. PO Box 54134,<BR>
  254. Bucklands Beach,<BR>
  255. Auckland,<BR>
  256. New Zealand.<BR>
  257. </DL>
  258.  
  259. <HR><!-- *** INDEX *** -->
  260. <A NAME="Index"><H1>Index</H1></A>
  261. <UL>
  262. <LI><A HREF="#AddSample">Adding Samples</A>
  263. <LI><A HREF="#Author">Author</A>
  264. <LI><A HREF="#Config">Configuration</A>
  265. <LI><A HREF="#Disclaimer">Disclaimer</A>
  266. <LI><A HREF="#Freeware">Freeware</A>
  267. <LI><A HREF="#History">History</A>
  268. <LI><A HREF="#Install">Installation & Use</A>
  269. <LI><A HREF="#Interface">Interface</A>
  270. <LI><A HREF="#Requirements">Requirements</A>
  271.  
  272. </UL>
  273. <HR>
  274.  
  275. Documentation written by <A HREF="#Author">David Swasbrook</A>.<BR>
  276. Last updated on
  277. Mon Apr 22 20:19:55 1996
  278.  
  279. </BODY>
  280. </HTML>
  281.